home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
wildcat
/
wctoday.zip
/
WCTODAY.DOC
< prev
next >
Wrap
Text File
|
1991-08-01
|
14KB
|
313 lines
Who Called Today? Version 3.5
-= For Wildcat! 3.XX systems only =-
Copyright (c) 1989,91 Boardwalk Software - All Rights Reserved.
Technical Support and the latest versions!
The Boardwalk! (206) 941-3124 (DATA)
Who Called Today? A bulletin/hello screen generator for Wildcat! BBS systems.
─────────────────────────────────────────────────────────────────────────────
Disclaimer
Boardwalk Software hereby disclaims all warranties relating to this product,
whether express or implied, including without limitation any implied
warranties of merchantability or fitness for a particular purpose. Boardwalk
Software cannot and will not be liable for any special, incidental,
consequential, indirect or similar damages due to loss of data or any other
reason, even if Boardwalk Software or an authorized Boardwalk Software agent
has been advised of the possibility of such damages. In no event shall the
liability for any damages ever exceed the price paid for the license to use
software, regardless of the form and/or extent of the claim. The user of
this program bears all risk as to the quality and performance of the
software.
Copyright
Regardless of the method of marketing used, WCToday is NOT in the "Public
Domain". It is copyrighted by Dave Cody and Boardwalk Software.
License
Who Called Today? (WCToday) is a Shareware product. As such, it is made
available to the general computing public for evaluation. Users are
licensed to operate WCToday on their personal computers for the purpose of
test and evaluation on a trial basis for a limited trial period. It is not
possible to reasonably define any definitive limits of a fair and equitable
time period for evaluation, therefore, it is left to the user's decision as
to its usefulness. If the user decides the program is not of sufficient
merit to warrant purchase through registration with Boardwalk Software, the
program should be removed from their personal computer. Otherwise, if the
program is deemed useful and is in regular use on the user's personal
computer system, registration with Boardwalk Software is required.
Registration
You may register WCToday by sending the enclosed REGISTER.DOC along with a
check in the amount of $10.00 to Dave Cody at the address listed below:
Dave Cody
P.O. Box 99948
Tacoma, WA 98499
WASHINGTON RESIDENTS MUST INCLUDE 8.2% SALES TAX.
Technical Support
Comments and suggestions about WCToday are welcome as well as any comments
or suggestions that you may have in terms of additional utilities you would
like to see written. Please call The Boardwalk! at (206) 941-3124. I can
also be reached via Fidonet at 343/47 and Mustang Software Support BBS.
Who Called Today? A bulletin/hello screen generator for Wildcat! BBS systems.
─────────────────────────────────────────────────────────────────────────────
A sample of the output
┌─────────────────────────────────────────────────────────────────────────────┐
│ The Boardwalk! presents Who Called Today! │
│ │
│ Last ┌Todays Totals────────┐ │
│ L Caller Calling From Called Calls Time Dls Uls Msgs │
└─────────────────────────────────────────────────────────────────────────────┘
2 JIM BREWER New Port Richey, FL 15:29 2 13 10 0 5
1 DAVE MCKILLOP Des Moines, WA 18:53 2 33 1 0 0 NC
1 CHIP NORTH Torrence, CA 19:11 1 4 2 0 1 N
2 MARC HUFNAGEL Murphysboro, IL 19:24 1 5 0 2 2
Activity for 04-03-91 includes 6 call(s) for 0 hour(s) and 55 minute(s).
┌─────────────────────────────────────────────────────────────────────────────┐
│ Downloads: 13 Uploads: 2 Messages: 8 Drop Carriers: 1 New Users: 2 │
└─────────────────────────────────────────────────────────────────────────────┘
WCToday 3.50 Copyright (c) 1989,91 by Dave Cody and Boardwalk Software
Operation
WCToday is a hello screen/bulletin generator for Wildcat! BBS systems. The
program should be run after each caller logs off and will update the screen
that you choose to show a listing of all the callers to your system, on each
node, along with several pieces of statistical information. Those are the
number of downloads, number of uploads, messages left, time on the system
and the last time called. At the bottom of the display screen totals are
shown reflecting all caller statistics for the day. As you can see from the
example I have included here that new callers to the system will be noted
with an N beside their name and callers who drop carrier during any call
will be noted with a C.
A brief history... WCToday reads the activity log for it's data. The
original program, Version 1, read from the beginning of the log to the end
of the log which took a considerable amount of time. With Version 2 it
began reading from the end of the log backwards to the beginning of the
day's activity which speeded things up quite a bit. Now, with Version 3,
WCToday will create a database and continue to add callers as the day goes
on so the program only has to read in the last caller each time, making it
extremely fast, as well as giving it true multi-node compatibility.
Multi-node compatibility was the main reason for rewriting the program with
the intent to be able to create one output file that included the activity
on all nodes. This feature is totally optional - it is configurable by the
Sysop - on a busy system this can be quite impressive. Ease of use was
another reason for rewriting WCToday. I have done away with the need to
place the complete path of the output file on the command line. All input
and output options are simple command line switches as explained below.
NOTE: Run WCToday with no parameters to see a brief synopsis of these
command line switches. Also, WCToday will only create the .SCR files if
you have specified that you are offering ANSI menus in Makewild.
Who Called Today? A bulletin/hello screen generator for Wildcat! BBS systems.
─────────────────────────────────────────────────────────────────────────────
Switches
Case is not important but each switch must be separated by a space.
/L - Scan Last
Scans the activity log for the last callers statistics, adds the caller to
the database, and creates the specified display file. If the caller is
already in the database their statistics will be modified to reflect their
totals for the day. A caller will have more than one entry in the database
by calling more than one node. An entry will be added for each node.
WCToday will also reset automatically after on the first caller after
midnight so there is no special nightime maintainence mode to run.
/A, A+ - Scan All
Scans the entire days activity for all callers and recreates the database.
You would normally use this switch only the first time you run the program
or any time you want to start it over.
By adding the "+" to this command line switch WCToday will not kill the
database allowing you to "add" the callers from other nodes. If you run a
multi-node system you will first run WCToday with the "/A" parameter from
Node1 and then run it with the "/A+" parameter from all other nodes you wish
to include in the display file.
NOTE: If you do not specify an output file with one of the following
switches, WCToday will create the files WCTODAY.BBS/SCR in the Node Home
directory from which it is run. This could be useful if you did not want to
create a conventional display file but wanted to see view the statistics.
/H# - create a HELLO file using the #
WCToday will look at you Wildcat! configuration and create a HELLOXX screen
in the proper path for "Display" files. Range can be 1 to 10.
/B# - create a BULLETIN file using the #
WCToday will look at you Wildcat! configuration and create a BULLXXXX screen
in the proper path for "Bulletin" files. Range can be 1 to 1000.
NOTE: The first time you run the program you will need to use either the /L
or /A switch in order to place some callers in the database, but after that
you can use the /H# or /B# to create just the display file if you like. If
there are no callers or if the program has not been run with the /L or /A
the output file will have the following line in it instead of callers names.
Congratulations! You are the first caller today!
/E# - Exclude all callers at security level #.
By default, WCToday will show the activity of all callers in the display
file, but if you do not want to show a specific security level you can force
it by using this switch. This switch will work for other levels. For
instance, you could prevent all callers at level WC100 with /EWC100. At the
present time you can only keep one security level at a time from displaying.
Who Called Today? A bulletin/hello screen generator for Wildcat! BBS systems.
─────────────────────────────────────────────────────────────────────────────
/S- - Turn off all noises.
By default, WCToday will make a bit of noise if it encounters a problem. If
it bothers you you can turn it off with this switch.
NOTE: On a single node system the errors should be very infrequent, but on
a multi-node system you may, occasionally, encounter a database lock that
causes the program to abort. More commonly there will be a conflict caused
by a caller on one node viewing the display file while another node is
trying to write to it. If the noise bothers you, turn it off.
/D- - Exclude the C for dropped carriers from the display.
By default, WCToday will place a C next to a callers statistics line if they
have dropped carrier during the day. Some Sysops do not want to show this
since some drop carriers are unavoidable.
/T- - Swap baud rate for last call time.
By default, WCToday will display the callers last logon time, but if for
some reason you don't want to show this or would rather show the baud rate
you can use this switch to change it.
/N- - Multi-node privacy switch.
This switch will allow you to create Node specific display files. It will
force WCToday to only show the activity for the Node that calls the program.
WCToday will create the database in your user data directory with a number
on the end indicating the node it is from.
Setting up your batch file
After you have created the database the first time with the /A parameter
(and the /A+ parameter if you are multi-node) you will run it after each
caller logs off with something like the following:
WCTODAY /L /H2 Scans the last caller and creates the HELLO2.BBS/SCR.
WCTODAY /L /B10 Scans the last caller and creates the BULL10.BBS/SCR.
WCTODAY /L /B10 /T- Scans the last caller and display baud rates instead
of logon times.
WCTODAY /L /H2 /E1000 Exclude the Master Sysop in the display file.
WCTODAY /L /H2 /N Create a HELLO2 file with only callers from this node.
There are too many combinations to show them all, but the idea was to make
the command line as clean as possible. I hope we accomplished that.
─────────────────────────────────────────────────────────────────────────────
Who Called Today? A bulletin/hello screen generator for Wildcat! BBS systems.
POSTCALL.BAT
You will need to create a file called Postcall.bat that will be called by
Wildcat! by default when a caller exits. I have included a sample for you.
Acknowledgements
WCToday was written in Turbo Pascal v6.0 from Borland International with
additional help from Turbo Power Software in Scotts Valley, CA in the use
of their outstanding Btree Filer and Object Professional libraries for
Turbo Pascal. And of course, none of this would have been possible (or
necessary) without Mustang Software and their excellent bulletin board
program - Wildcat!. Thank you!
Other programs by Boardwalk Software
The Master Series - File Master, User Master, and Message Master
Wildcat! database managers for Wildcat! v2.XX
Purge - Purge your activity log of local and Sysop logons.
Lopper - "Lop" off your activity log based on a number of days.
WCToday1 - An early version of WCToday for WC! Test-Drive
WCToday2 - An early version of WCToday for WC! v2.00
Authenticity Verification
This archive has been zipped using Boardwalk Software's authenticity
verification number from PKWare. If there are any files in the archive that
do not have the verification tag beside them it indicates that the archive
has been tampered with and is not in it's original form. If this is the
case, please call the support bbs - The Boardwalk! - and get a clean copy.